package com.dts.yjnb.service.mapper;

import com.dts.yjnb.service.domain.NbAllowancePolicy;
import com.dts.yjnb.service.domainDto.AllowancePolicyDTO;
import com.dts.yjnb.service.domainVo.AllowancePolicyVo;
import com.dts.yjnb.service.domainVo.AppAllowancePolicyVo;
import com.github.pagehelper.Page;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import java.util.List;

/**
 * 补贴政策Mapper接口
 *
 * @author jyn
 * @date 2024-09-29
 */
@Mapper
public interface NbAllowancePolicyMapper
{
    /**
     * 查询补贴政策列表（管理端）
     *
     * @param allowancePolicyDTO 查询条件
     * @return 补贴政策列表
     */
    List<AllowancePolicyVo> selectAllowancePolicyList(AllowancePolicyDTO allowancePolicyDTO);

    /**
     * 查询补贴政策列表（APP端）
     *
     * @param appAllowancePolicyVo 查询条件
     * @return 补贴政策列表
     */
    List<AppAllowancePolicyVo> appQueryAllowancePolicy(AppAllowancePolicyVo appAllowancePolicyVo);
    
    /**
     * 删除补贴政策（单个或批量）
     *
     * @param ids 补贴政策ID数组（逗号分隔的字符串将被转换为数组）
     * @return 结果
     */
    public int deleteNbAllowancePolicyByIds(String[] ids);

    /**
     * 搜索补贴政策信息
     * 
     * @param searchDTO 搜索条件
     * @return 补贴政策列表
     */
    List<AllowancePolicyVo> searchAllowancePolicy(AllowancePolicyDTO searchDTO);
    
    /**
     * 新增补贴政策
     * 
     * @param allowancePolicyDTO 补贴政策信息
     * @return 结果
     */
    int insertAllowancePolicy(AllowancePolicyDTO allowancePolicyDTO);
    
    /**
     * 补贴政策分页查询
     *
     * @param allowancePolicy 查询条件
     * @return 分页结果
     */
    Page<NbAllowancePolicy> page(NbAllowancePolicy allowancePolicy);
    
    /**
     * 根据ID查询补贴政策详情
     *
     * @param id 补贴政策ID
     * @return 补贴政策DTO
     */
    AllowancePolicyDTO getAllowancePolicyById(String id);
    
    /**
     * 修改补贴政策
     *
     * @param allowancePolicyDTO 补贴政策信息
     * @return 结果
     */
    int updateAllowancePolicy(AllowancePolicyDTO allowancePolicyDTO);
    
    /**
     * 单个修改发布状态
     *
     * @param id 补贴政策ID
     * @param status 发布状态：1已发布 0未发布
     * @return 结果
     */
    int updateStatusById(@Param("id") String id, @Param("status") Integer status);
    
    /**
     * 单个修改推荐状态
     *
     * @param id 补贴政策ID
     * @param isRecommend 推荐状态：1推荐 0不推荐
     * @return 结果
     */
    int updateRecommendById(@Param("id") String id, @Param("isRecommend") Integer isRecommend);
}
